home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / dvsv16.zip / DVSWITCH.DOC < prev    next >
Text File  |  1993-12-27  |  37KB  |  772 lines

  1.  
  2.  
  3.  
  4.  ┌─────────┐  ╓──┐ ╓─╥─┐ ╓──┐
  5.  └┐  ┌───┐ └┐ ╟──┤   ║   ╟──┤
  6.   │  │   │  │ ╨  ┴   ╨   ╨  ┴
  7.   │  │   │  │  ┌────┐    ┌────┐ ╓──┐ ─╥─ ╓──┐ ╥──┐
  8.   │  │   │  │  └┐  ┌┘    └┐  ┌┘ ║  │  ║  ║    ╟─
  9.   │  │   │  │   └┐ └┐    ┌┘ ┌┘  ╙──┘ ─╨─ ╙──┘ ╨──┘
  10.  ┌┘  └───┘ ┌┘    └┐ └┐  ┌┘ ┌┘  ┌─────────┐ ╥ ╥ ┬ ─╥─ ╓─╥─┐ ╓──┐ ╥  ┬
  11.  └─────────┘      └┐ └┐┌┘ ┌┘   │  ┌────┐ │ ║ ║ │  ║    ║   ║    ╟──┤
  12.                    └┐ └┘ ┌┘    │  │    └─┘ ╙─╨─┘ ─╨─   ╨   ╙──┘ ╨  ┴
  13.                     └┐  ┌┘     │  └──────┐           version 1.6
  14.                      └──┘      └──────┐  │ (c) 1993 Datagen Software Designs
  15.                                ┌─┐    │  │written & programmed by John Dailey
  16.                                │ └────┘  │
  17.                                └─────────┘
  18.  
  19.  
  20.                            WARRANTY and DISCLAIMER
  21.                            ───────────────────────
  22.  
  23.         This  software  is  provided  AS IS without any expressed or
  24.         implied warranties whatsoever. No warranty of fitness for  a
  25.         particular  purpose  is offered. The author of this software
  26.         cannot be held responsible for DIRECT, INDIRECT  INCIDENTAL,
  27.         CONSEQUENTIAL,  or  ANY OTHER damages due to your ability or
  28.         inability to use this software, even if the author has  been
  29.         advised of the possibility of such damages. The user assumes
  30.              full responsibility for the use of this software.
  31.  
  32. File Included In This Package:
  33. ──────────────────────────────
  34.  
  35.      DVSWITCH.DOC --- This Documentation File
  36.      DVSWITCH.HIS --- History File
  37.      DVSWITCH.REG --- Registration Form
  38.      UPGRADE .EXE --- Upgrade Program From DVS v1.0 to DVS v1.5
  39.      DVSETUP .EXE --- Executable .EXE Setup Program
  40.      DVSWITCH.EXE --- Executable DVS Program
  41.      WWIV    .BAT --- Sample WWIV BBS 2400bps Batch File
  42.      RA      .BAT --- Sample RA BBS 2400bps Batch File
  43.  
  44.  
  45. Files Created By This Software:
  46. ───────────────────────────────
  47.  
  48.      DVSWITCH.CFG --- Program Configuration File
  49.      DVSWITCH.NFO --- Event Information (Deleted Automatically)
  50.      DVSWITCH.DAT --- Data File For Program Info
  51.      MMDDYY  .DVS --- Log File
  52.  
  53. What Is It?:
  54. ────────────
  55.  
  56.      DVSwitch (Data/Voice Switch) is a small utility that allows a sysop to
  57. have both a voice and a data line at the same time.  The program, itself,
  58. simply answers the phone upon ringing, waits for carrier, and depending on
  59. the results, either loads the BBS up with a caller already on line, or rings
  60. the PC's speaker in a telephone sound.
  61.  
  62.      If a sysop wishes to use his voice line as both data and voice, all
  63. he/she needs to do is simply run DVS's setup program, load the program BEFORE
  64. loading his/her BBS, and wait.  The program is, for the most part, totally
  65. independent.
  66.  
  67. DVSETUP.EXE - The Setup Program:
  68. ────────────────────────────────
  69.  
  70.      Note that if you are upgrading from version 1.0, you should first run
  71. the UPGRADE.EXE program within your DVS directory BEFORE running DVSETUP.EXE!
  72.  
  73.      To load the setup program, type DVSETUP at the DOS prompt.  After
  74. loading, a "Warranty and Disclaimer" Screen will pop up.  Be sure to read
  75. what is stated, and press <ENTER> or <SPACE> to accept the agreement.  You
  76. will then see a menu bar at the top of the screen, and a status bar at the
  77. bottom.  If you have a mouse, you may use it at any time, by clicking on the
  78. item of your choice. Otherwise, press F10 to highlight the menu bar at the
  79. top of the screen.  Use the arrow keys to move the highlight bar, and <ENTER>
  80. or <SPACE> to select an option.
  81.  
  82.      Datagen
  83.  
  84.      Under this menu selection, you will find three things, all of which are
  85.      simply information pertaining to Datagen Software Designs, and the
  86.      program itself.
  87.  
  88.      Setup Program
  89.  
  90.      Here, you will find options to save your current settings, load
  91.      previously saved settings, restore defaults, and exit to DOS.  Most are
  92.      self-explanatory, and therefore require no explanation, however,
  93.      "Restore Defaults" does.  This option simply resets all of DVSETUP's
  94.      settings to those predefined by the program.  They are mostly, if not
  95.      definitely standard settings that should work fine with just about any
  96.      user.  Please be sure to save your settings before exiting the setup
  97.      program.
  98.  
  99.      Modem Configuration
  100.  
  101.      Underneath this menu are selections that are specific to your modem. 
  102.      Please note that these settings should be setup exactly the same as you
  103.      have them set up for the BBS program.  Otherwise, some conflict may
  104.      occur.
  105.  
  106.           Communication Parameters
  107.  
  108.           These settings are for communications ports, baud rates, parity,
  109.           stop and data bits.  Set them according to what they need be. 
  110.           Standards for parity is 'None.'  For data bits, it is usually '8',
  111.           and for stop, usually '1.'  Consult for modem instruction manual
  112.           for more information.
  113.  
  114.           Modem Specifications
  115.  
  116.           This setting is basically hardware reliant.  High-speed modem users
  117.           should most likely turn this option (CTS/RTS) on, while lower speed
  118.           modem users may need to experiment.
  119.  
  120.           Modem Input Strings
  121.  
  122.           These strings are for controlling the modem.  These settings MUST
  123.           be the same as you have for your BBS, otherwise, conflict will
  124.           occur.  It is suggested that you enter these in all capital
  125.           letters, and consult your modem guide for a complete description.
  126.  
  127.           Be advised that in order for ring and baud rate detection to occur,
  128.           voice result codes must be turned on.  Usually, this is done by
  129.           either adding an 'X1' or 'X4' to the modem initialization string.
  130.  
  131.           Modem Initialization String - This string is sent to your modem
  132.           upon startup.  It tells the modem how to run, basically.  The
  133.           default (and pretty much standard) setting for this is:
  134.  
  135.           ATQ0V1X4M0
  136.  
  137.           'AT' tells the modem 'ATtention!', and get ready for commands.  The
  138.           Q0 tells the modem that result codes are to be sent to the screen. 
  139.           'V1' states that verbal codes will be used instead of numeric
  140.           codes.  'X4' tells the modem to return result codes for such things
  141.           as ring detection, no carrier, and connection, and finally, 'M0'
  142.           tells the modem to leave the speaker off.
  143.  
  144.           Modem Answer Phone String - This string is the command that is used
  145.           to pick up the phone.  It is almost always 'ATA.'
  146.  
  147.           Modem Hang Up Command - This is the string that tells the modem to
  148.           hang up.  Standards for this include 'ATH' or 'ATH0.'
  149.  
  150.           Modem Off Hook Command - This string is the opposite of the Modem
  151.           Hang Up Command, therefore the standard is 'ATH1.'
  152.  
  153.      Program Specifics
  154.  
  155.      Underneath this menu are subtitles that reference basic program
  156.      functions, such as Event Setups, DOS exit codes, control of the
  157.      "telephone ring", and choices for screen savers.
  158.  
  159.           BBS Event Setup
  160.  
  161.           This choice brings up a dialogue box that deals with your BBS event
  162.           batch files.  The fact is that just about every BBS in the BBS
  163.           world, runs some kind of weekly, or nightly event, and since
  164.           DVSwitch is being run all the time, and not the BBS, the BBS
  165.  
  166.           program will not know when to run the events!  Therefore, an event
  167.           setup option has been included in DVSwitch, along with an option to
  168.           shut down DVS at a given time each day.
  169.  
  170.           Note: Unregistered copies of DVSwitch are allowed only one event.
  171.  
  172.           Each event (1-10) has two parameters that you must set in order for
  173.           them to work.  The first is the day of the week to run the event. 
  174.           Simply place an 'X' below the days (SMTWTFS) that the event is to
  175.           run.  The other parameter that you must set is the time that each
  176.           event is to run.  Simply enter the time in 24 hour format and
  177.           you're all set.  Refer to the section on DOS Exit Codes for more
  178.           information on how the events are handled by the program.
  179.  
  180.           The Shut Down event has to sections, a check-box that is checked if
  181.           DVS is to be shut down, and a time that the shut down is to occur
  182.           if it is turned on.  Again, the time is in 24 hour format.  Note
  183.           that unless you set up your batch file to do different, DVS will
  184.           terminate upon shut down and will not reload!
  185.  
  186.           A hint.  Because DVS cannot log a user off when an event is
  187.           supposed to be run, a good idea of practice is to "fool" your BBS
  188.           into thinking that it has to run an event.  Setup you BBS for the
  189.           same events and times as that of DVS.  That way, with most BBS
  190.           programs, if a users time conflicts with the event, it will log
  191.           them off early so that the event may be ran.  The events do not
  192.           HAVE to be ran at the time specified. For instance, if a user is on
  193.           your BBS when it's time to run the event, and they continue on the
  194.           BBS for another five minutes, DVS will NOT forget about the event.
  195.           It will however, run it as soon as the user logs off or gets logged
  196.           off.
  197.  
  198.           Also note that events have priority over the shut down event. If an
  199.           event has not yet been run for the day, and the event runs at the
  200.           same time as that last event, the event will be taken care of
  201.           first.
  202.  
  203.           As well as the event setup and shutdown information that is listed
  204.           on this menu, there are also two other options; off hook for event
  205.           and local logons.  Simply check both or either box to have DVS take
  206.           the modem off hook while it runs events, and/or when you drop to
  207.           the BBS locally.  The default for these are both on.  If you are
  208.           running your BBS under an ARU (automatic reboot unit) that reboots
  209.           your computer after a certain number of rings, you should set both
  210.           of these options on.  That way, the user calling your board while
  211.           an event is being run will get a busy signal as well as when you
  212.           log on to the BBS locally.
  213.  
  214.           Please note that taking the modem off hook when running the BBS in
  215.           local mode is toggleable from inside DVS, and each time DVS is
  216.           loaded, it will default to the setting you have specified.
  217.  
  218.      Exit Information
  219.  
  220.      This setting is used by the program upon exit.  Due to the fact that
  221.      many BBS programs use a considerable amount of memory, and are very
  222.      picky, DOS error codes were decided as the choice for loading the BBS,
  223.      and running nightly events.  Basically, the idea here was to remove the
  224.      program from memory totally, instead of keeping it memory resident, and
  225.      possibly creating conflicts with FOSSIL drivers, or the BBS programs
  226.      themselves.
  227.  
  228.           Exit Modifier Code - If the modem connects to another modem, or if
  229.           an event is to be run, this modifier will determine which exit code
  230.           to send to your batch file.  For example:  If your maximum baud
  231.           rate is 2400, and you set your modifier code to 0, the following
  232.           exit codes would be returned based on baud rates:
  233.  
  234.                         1  - 1200bps
  235.                         2  - 2400bps
  236.                         3  - Local Exit To BBS
  237.                         4+ - Event Exit Codes
  238.  
  239.           ,but if your maximum baud rate was 2400, and your modifier code was
  240.           10, the following codes would be returned to DOS:
  241.  
  242.                         11  - 1200bps
  243.                         12  - 2400bps
  244.                         13  - Local Exit To BBS
  245.                         14+ - Event Exit Codes
  246.  
  247.           If your maximum baud rate was 9600 and your modifier code was 3,
  248.           the following codes would be returned to the batch file:
  249.  
  250.                         4  - 1200bps
  251.                         5  - 2400bps
  252.                         6  - 9600bps
  253.                         7  - Local Exit To BBS
  254.                         8+ - Event Exit Codes
  255.  
  256.           Basically, each baud rate has a number associated with it:
  257.  
  258.                         1200 = 1
  259.                         2400 = 2
  260.                         9600 = 3
  261.                         192k = 4
  262.                         384k = 5
  263.                         576k = 6
  264.                         Local = Highest Baud # + 1
  265.                         Event = Local (Highest Baud # + 1) + Event Number
  266.  
  267.           ,and the modifier code you specified is added to that number to get
  268.           the DOS exit code.
  269.  
  270.           The local exit code is derived from the number associated with the
  271.           highest baud rate your modem can use.  If your highest baud rate
  272.           was 2400 and you had a exit code modifier of 0, then the local exit
  273.           code would equal 3.  To keep it simple, the local exit code is
  274.           always one number higher than the exit code associated with your
  275.           highest baud rate + the modifier code.
  276.  
  277.           The event exit codes are at least 1 higher than the local logon
  278.           exit code.  To figure these numbers, first, take the highest
  279.           corresponding baud rate number (1-6), add 1 to skip over the local
  280.           exit code, and then add the appropriate event number.
  281.  
  282.           Please Wait String - This part of the sub-menu is simple.  This
  283.           string is the string that is sent to the user when both modems
  284.           connect.  It should simply state that the BBS is loading, please
  285.           wait, but you may enter a personalized saying of up to 80
  286.           characters to send to the user.
  287.  
  288.           Note:  Only registered version of DVS utilize the Please Wait
  289.           option.
  290.  
  291.      Ring Information
  292.  
  293.      This submenu controls the way the "telephone ring" will sound.  You may
  294.      set these settings any way you wish.  Press F5 from the main menu area
  295.      to hear a demo sound of what the rings will sound like.
  296.  
  297.           High pitch - This is the high pitch of the ring sound.  The minimum
  298.           for this value is 100, and the maximum is 32000.
  299.  
  300.           Low pitch - The lowest pitch of the ring.  It's range is also from
  301.           100 to 32000.
  302.  
  303.           Ring length - This value determines the length if each ring.  The
  304.           lowest value for this option is 1 and the highest is 20.  The
  305.           default is 10.
  306.  
  307.           Delay - This number signifies the amount of time to delay between
  308.           rings.  Default is 2000, which is about 2 seconds. Minimum value
  309.           for this setting is 100, maximum is 5000.
  310.  
  311.           Carrier - This value determines the number of seconds to wait for
  312.           a carrier detection.  Minimum value is 1, and the highest is 40
  313.           seconds.  More than likely, the default setting of 10 seconds will
  314.           be more than enough.  If a carrier is not detected in this amount
  315.           of time, the program will assume that a voice user is calling the
  316.           computer, and will therefore, ring the speaker.  Depending on your
  317.           modem, some may require that this setting be significantly lower or
  318.           higher.
  319.  
  320.           Hang Up # - This signifies the total number of rings before voice
  321.           caller is hung up on.  Default is 5, and it may range anywhere from
  322.           2 to 20 rings.
  323.  
  324.           Mute On Start - If this item is checked, DVSWITCH will load up in
  325.           mute mode.  This means that instead of ringing the computer's
  326.           speaker, a message will be printed on the screen.
  327.  
  328.           It's a good idea to check this box, and have DVS load up mute
  329.           first. That way, if your computer reboots during the night for
  330.           example (if you're using an ARU), and DVS reloads, it will still be
  331.           in mute mode.  Otherwise, the program will load with mute mode off,
  332.           and will ring the PC's speaker if a voice user calls - definitely
  333.           a rude awakening.  If you are around and awake, you then can toggle
  334.           mute mode by pressing [ALT][M] in DVS.
  335.  
  336.           Note that by pressing F5 from the main menu will give you a sample
  337.           ring based on what is entered.
  338.  
  339.           Screen Savers
  340.  
  341.           This submenu is where you will find information pertaining to
  342.           screen savers.  Simply choose the one you wish to use, and you're
  343.           all set.  If you choose the last option ('RANDOM'), the program
  344.           will rotate randomly through all of the screen savers. The 'DELAY'
  345.           option controls how long each screen saver will be active when in
  346.           random mode.  Minimum value for this delay is 10 seconds, maximum
  347.           is 59 seconds.  The option for 'INFO DELAY' controls how many
  348.           seconds to wait before turning the information bar on and off. 
  349.           Default is 30 seconds, the maximum being 59 seconds, and the
  350.           minimum 10.  Last, but not least is an option to have the 'CLOCK'
  351.           on the screen at all times.  If this checkbox is marked, the clock
  352.           will move across the bottom of the screen when the information bar
  353.           is not on so that the time is continuously visible.
  354.  
  355.           There are 10 different screen savers to select from, and here is a
  356.           description for each of them:
  357.  
  358.           Default - Nothing special, no action.
  359.  
  360.           Random Cursor Movement - Cursor is randomly placed all over the
  361.           screen to create a "sparkle" effect.
  362.  
  363.           Hyperspace - "Stars" move across the screen at different speeds,
  364.           making it look like you're traveling through space.
  365.           Pong - Watch the computer play pong!
  366.  
  367.           Bugs - Little animated bugs walk all over your monitor.
  368.  
  369.           Raindrops - Streaks of water fall down, creating a rain effect.
  370.  
  371.           Bouncing Balls - Balls bouncing around the borders of the screen,
  372.           colliding with each other.
  373.  
  374.           Lines - Lines that appear like zooming stars zip across the screen
  375.           from both directions.
  376.  
  377.           Swirly - Computer "garbage" swirls around the screen, and
  378.           disappears.
  379.  
  380.           Rockets - Rockets blast off at lightning screen.
  381.  
  382. DVSWITCH.EXE - The Main Program:
  383. ────────────────────────────────
  384.  
  385.      If you have run the setup program, and installed the program, you're
  386. ready to go.  Now, let's run through how the actual program looks and feels!
  387.  
  388.      The Screen
  389.  
  390.      The screen is set up as simple as possible.  At the top is, of course,
  391. a plug for the program.  At the bottom is a note as to the most important
  392. keys that are used by the program, and the current time in the right hand
  393. corner.  These two lines turn off and on automatically at a duration that you
  394. specify in seconds to minimize screen burn in.  If the bars are not on, and
  395. the clock has been set to be displayed at all times, it will move across the
  396. bottom of the screen.
  397.  
  398.      Here are those keys, and their descriptions:
  399.  
  400.      [ALT][X] - Exits to DOS.  This is self explanatory.  This option does
  401.      not exit and load the BBS, it exits to the DOS prompt, unless you've set
  402.      DVS up to do otherwise.
  403.  
  404.      [ALT][M] - Mute Mode [On/Off] This quick key simply toggles mute mode on
  405.      or off.  The current state is shown in brackets.  If mute mode is off,
  406.      your computer will ring if an incoming voice call in intercepted,
  407.      otherwise, as message will be printed on the screen telling you that
  408.      there is a voice user on-line.  Upon loading up the program, this
  409.      setting defaults to what you have setup in your configuration file.  A
  410.      good idea is to default mute mode to on, and when you are at home (or
  411.      not asleep!), turn it off, so that you can hear the ring.
  412.  
  413.      [ALT][B] - Exit to BBS.  This will drop to DOS and load the BBS in local
  414.      mode.
  415.  
  416.      There are a few more keys not shown at the bottom of the screen.  Here
  417.      are their listings and descriptions:
  418.  
  419.      [ALT][F] - Force Event.  This key combination will force an event that
  420.      has been setup.  (Unregistered versions may only run and force 1 event.) 
  421.      If you force an event that has not been defined, the program will simply
  422.      return to waiting for caller.
  423.  
  424.      [ALT][I] - Information Bar.  This key toggles the top and bottom lines
  425.      of the screen.
  426.  
  427.      [ALT][L] - Off Hook Local.  This key toggles the current state of taking
  428.      the modem off hook for local logon to the BBS.
  429.  
  430.      [ALT][N] - New Screen Saver.  This key will simply pick a random screen
  431.      saver.  If you are running with random screen savers already, it will
  432.      change again, otherwise, it will remain to the new one.
  433.  
  434.      [ALT][S] - Status Screen.  This key combination brings up a screen that
  435.      displays the current program status for the day.  It gives the current
  436.      communications port, baud rate, state of off hook for events and local
  437.      logons, total amount of data calls for the day, total amount of voice
  438.      calls today, total amount of local logons today, and a listing of events
  439.      to be run.  If an event has already been ran, a check mark will appear
  440.      next to it's time.  If an event is not defined, it is shown as "#?
  441.      --:--."  Also, if shut down is active, the time it is to occur is shown.
  442.  
  443.      If you bring this screen up, and do not press a key within 15 seconds,
  444.      it will automatically shut off.
  445.  
  446.      [ALT][V] - View Log File - This key simply loads the current day's log
  447.      file and display's it to the screen.  This was added so that you didn't
  448.      have to keep exiting the program to read the logs.  Note that as well as
  449.      with the ALT-S function, this function, if you do not press a key within
  450.      15 seconds will "un"pause itself, and then quit back to DVS waiting for
  451.      a caller.
  452.  
  453.      Note:  Viewing of the log file from within DVS is only supported by
  454.      registered copies.
  455.  
  456.      The rest of the screen is blank - for now.  Most of the action takes
  457. place here.  While waiting for a call, your chosen screen saver will be
  458. active here. When receiving a call, or if an event is being executed,
  459. information as to what is happening will appear in this area.
  460.  
  461.      The Action!
  462.  
  463.      When a call is detected, here is what happens:
  464.  
  465.      Phone is answered, and carrier connection attempted.  (the only bad part
  466.      of this is that if it is a voice call, the person will hear the modem's
  467.      high pitched tone.  It is wise to let people know that you are running
  468.      a BBS on the same line, and they will hear that tone.  Be sure they know
  469.      to stay on the line.  Every way possible around this was tried, but
  470.      unfortunately, the only way was to purchase a voice/data switch box
  471.      which cost around $90!  We assumed that this was only a SMALL price to
  472.      pay.)
  473.  
  474.      Note that at any time, you may press any key (preferably the space bar)
  475.      to abort and hang up the modem.  Useful if some annoying user keeps
  476.      calling and calling and calling...
  477.  
  478.      If a carrier connected, the program sends a note to the user to please
  479.      wait, notifies the sysop that someone has connected, and at what baud
  480.      rate. then exits and loads the BBS with a user already on-line.
  481.  
  482.      For information on loading your BBS program with a remote user already
  483.      online, please consult your BBS software documentation.  Most BBS
  484.      program require passing of specific command line parameters, such as
  485.      baud rate, com port, etc.
  486.  
  487.      *** Be sure to exit the BBS program after a caller logs off so that
  488.      DVSwitch is ran again!
  489.  
  490.      If a carrier did not connect in a time limit that you specify, the
  491.      program then proceeds to ring the sysop's PC speaker in the desired
  492.      tone.  After a given number of rings, if no one answered, the phone is
  493.      hung up, and the program resets to wait for another call.
  494.  
  495.      If the sysop answers the phone, he/she should press a key or wait for
  496.      the amount of rings for the modem to hang up.  The program will reset
  497.      and wait for another call.
  498.  
  499.      During an event handling routine, things appear differently.  First, a
  500.      file is written (DVSWITCH.NFO) that will inform the program when it
  501.      returns from the event batch file that it is returning from an event
  502.      routine.  This file is very important for correct executing of BBS
  503.      events.  Upon returning from the event, the file is read, and then
  504.      deleted.
  505.  
  506.      If for any reason, your BBS crashes during the event, or crashes at any
  507.      time between DVSwitch's exit to run the event, and loading up DVSwitch
  508.      again, and DVS is not run, be sure to delete the file DVSWITCH.NFO so
  509.      the program will function properly.  Do not worry if this file is not
  510.      deleted!  The program will simply think that the event was run and will
  511.      delete the file itself.  However, it is a good idea to delete if
  512.      manually if anything does go wrong.
  513.  
  514.  
  515.      That is the simplest description to be given of what the program
  516. actually does.  It is simple enough, and after installation, easy to use.
  517.  
  518. DVSWITCH.NFO, DVSWITCH.DAT & ??????.DVS - The Files:
  519. ────────────────────────────────────────────────────
  520.  
  521.      After running DVS and getting the "feel" for it, you will notice that it
  522. creates a few files for both you and itself.
  523.  
  524.      The first file that it creates is DVSWITCH.NFO.  This file is for the
  525.      program while it is running.  It simply holds the program setting
  526.      information so that they stay the same while it is running.  For
  527.      example, say you've gone to bed one night, and mute mode was on so that
  528.      you wouldn't get woken up if a voice user called.  Without this file, if
  529.      a user called and logged on to your BBS, the mute mode variable would be
  530.      reset to whatever you have it setup to be in the configuration file.  If
  531.      you have it set to originally be on in the config file, then when DVS
  532.      loads back up, and say a voice person calls, you will get a definite
  533.      rude awakening.  This file is erased occasionally, when it does not need
  534.      it any longer.
  535.  
  536.      The next file, and probably the most important is the DVSWITCH.DAT file. 
  537.      This file holds a few things, the first being how many data, voice, and
  538.      local calls you've received for the day.  It also keeps track of which
  539.      events have and have not been ran.  If for any reason you NEED to run
  540.      the events, and they've already been run, simply delete this file, and
  541.      DVS will run them again.
  542.  
  543.      The last file changes it's name frequently.  These are the ".DVS" files. 
  544.      What these are, are log files that keep track of what goes on while DVS
  545.      is running.  It's main purpose is to let the sysop know what kind of
  546.      caller (voice or data) called when, and if it was data, what baud rate
  547.      they called at.  It also shows when an event was ran, and at what time. 
  548.      For security reasons, it also tells when someone uses the ALT-B function
  549.      to log on locally to the BBS.
  550.  
  551.      Each night at midnight, or when the user on at midnight logs off, a
  552.      "Newday" event is ran that writes the days information to the current
  553.      log file, closes it, and resets all values such as data and voice calls
  554.      for the day to zero.
  555.  
  556.      As I've said before, the name of the log files change with the date. 
  557.      The name is figured in this format:
  558.  
  559.                         MMDDYY.DVS
  560.  
  561.      , where MM = the current month (01-12), DD = the current day (01-31) and
  562.      YY = the last to digits of the current year.
  563.  
  564.      Note: Only registered copies of DVS create the log files.
  565.  
  566. Event Information:
  567. ──────────────────
  568.  
  569.      By now, you're probably ready to set the program up, but before you do
  570. that, you may want to know a few things about the way DVS and it's events
  571. work with your BBS.
  572.  
  573.      First, of all, it's simple!  You can even load the BBS from your event
  574. routine so that it takes care of the events you've already set up with the
  575. BBS!  If you do this, though, be sure to load the BBS so that it exits after
  576. running the event so that DVS is loaded and ran again.
  577.  
  578.      If you are receiving NETmail, fear not.  If the NET calls your computer,
  579. it should work just fine.  It has been tested with WWIVNet thoroughly, and
  580. should work with most NET software.
  581.  
  582.      If you need to use the NET software to call out at any time during the
  583. night, or day, simply set it up in your event routine as described below.
  584.  
  585.      Using the [ALT][F] function to force an event is great for forcing
  586. NETwork callouts.  If you have set up an event to do a callout with your
  587. NETwork software, you can force that event at any time with the [ALT][F]
  588. keys.  Note that if an event has not ran for the day, and you force it to, it
  589. will still run at the assigned time you've set up.
  590.  
  591. INSTALLING DVSwitch v1.6 On Your System:
  592. ────────────────────────────────────────
  593.  
  594.      To shorten the length of this explanation, and keep it as simple as
  595. possible, we assume that you have a basic knowledge of DOS, or know someone
  596. that can help you with this installation.  It is far from difficult, but no
  597. minor details are given, and therefore, the installation process may be
  598. difficult for someone who has no general knowledge of DOS.
  599.  
  600.      Installing For The First Time
  601.  
  602.      1.]  Unarchive the DVS files into your main directory.
  603.      2.]  Run DVSETUP.EXE to create configuration file.
  604.      3.]  Using a plain ASCII text editor, edit your BBS batch file.
  605.  
  606.                 @echo off
  607.                 goto start
  608.  
  609.                 :baud1200
  610.                 <command line to load BBS at 1200> (See BBS Manual)
  611.                 goto start
  612.  
  613.                 :baud2400
  614.                 <command line to load BBS at 2400>
  615.                 goto start
  616.  
  617.                 :baud9600
  618.                 <command line to load BBS at 9600>
  619.                 goto start
  620.  
  621.                 :localuser
  622.                 <command line to load BBS locally>
  623.                 goto start
  624.  
  625.                 :event1
  626.                 <instruction for event>
  627.                 <NET callouts?>
  628.                 <BBS userlist utilities?>
  629.                 <Log file utilities?>
  630.                 <File utilities?>
  631.                 goto start
  632.  
  633.                 :event2
  634.                 <instruction for event>
  635.                 goto start
  636.  
  637.                 :start
  638.                 {
  639.                   Your instruction goes here
  640.                 }
  641.                 DVSWITCH
  642.                 if errorlevel = <exitcode_event2> goto event2
  643.                 if errorlevel = <exitcode_event1> goto event1
  644.                 if errorlevel = <exitcode_local> goto localuser
  645.                 if errorlevel = <exitcode_9600baud> goto baud9600
  646.                 if errorlevel = <exitcode_2400baud> goto baud2400
  647.                 if errorlevel = <exitcode_1200baud> goto baud1200
  648.  
  649.  
  650.      (There are two sample .BAT files included with this package.  They are
  651.      both based on a 0 as the exit code modifier.)
  652.  
  653.      Please be aware that the ERRORLEVEL format must remain from greatest to
  654.      lowest ERRORLEVEL code!  If it is not, the it will not function
  655.      properly.  Unfortunately, this is DOS at its pickiest, and cannot be
  656.      overcome.
  657.  
  658.      Also, be sure that you don't call any batch files from within this batch
  659.      file routine for DVS, unless you have a utility that allows you to do
  660.      so.  If you do, the called batch file will end, and will not return
  661.      control to your DVS batch file.  In other words, DVS will not load
  662.      again.
  663.  
  664.      4.] Run the batch file, and you're all set!
  665.  
  666.      Upgrading From Version 1.0 To Version 1.6
  667.  
  668.      First, run the program UPGRADE.EXE included with your 1.6 archive from
  669.      the same directory where your DVSWITCH.CFG file resides.  You may then
  670.      run the setup program and change the new options that are under the
  671.      submenus "Event Information" and "Screen Savers."
  672.  
  673.      The batch file that you used for version 1.0 will still function
  674.      properly with version 1.6.
  675.  
  676.      Upgrading From Version 1.5 To Version 1.6
  677.  
  678.      Simply replace your old executable files with the new ones.
  679.  
  680. Authors Notes And Credits:
  681. ──────────────────────────
  682.  
  683.      You may distribute this program freely as long as all files are kept
  684. together in their original archived form and are not modified in anyway.
  685.  
  686.      Questions, comments, complaints, or to receive a complete listing and
  687. description of all Datagen products, mail John Dailey at the below address,
  688. through Compuserve at 73124, 2612, through Internet at 73124.2612@cis.com,
  689. through Prodigy at ID# MKHH05B, or through WWIVNet at 23@4709 (Enigma).
  690.  
  691.      Thank you for your support!
  692.  
  693.           Data/Voice Switch v1.6
  694.           c/o John Dailey
  695.           1732 Wind Drift Rd.
  696.           Orlando, FL  32809
  697.  
  698.      There are quite a few people that have helped us during the production
  699. of Data/Voice Switch, and although we cannot list everyone, we would like to
  700. thank a few people whom without, this program would probably never have even
  701. been thought of, or available!
  702.  
  703.      A special thanks to Chris Bosdal, who spent $90 on a Voice/Data switch
  704. box, and asked Datagen Software Designs if there was possibly any cheaper way
  705. to do the same thing with a program.  Without that question, this program
  706. probably would have never became part of the Datagen Software Designs
  707. collection.
  708.  
  709.      An extra-special thanks goes to Cathy Nicoloff for realizing that most
  710. BBS's do, in fact, have nightly events that MUST be run, and suggesting that
  711. something be added into the source to handle this.  Now THAT is teamwork! 
  712. She also went through with me about 12 beta versions of the program in order
  713. to get it to work!
  714.  
  715. Registration Of Data/Voice Switch v1.6:
  716. ───────────────────────────────────────
  717.  
  718.      Data/Voice Switch v1.6 is being released under the Shareware policy. 
  719. You may use Data/Voice Switch for a trial period of 30 days free of charge. 
  720. After that time, if you find that you enjoy using Data/Voice Switch and plan
  721. on using it in the future, you must register your copy of the program for
  722. $8.00 US currency.
  723.  
  724.      Registration of the program entitles you to free updates of the same
  725. version number (ie. 3.x), along with a registered copy of the version you are
  726. registering.  Registering version 1.6 adds the "Please Wait" option, enables
  727. the sysop log file feature, and also allows you to view the log files from
  728. within Data/Voice Switch.  Registration also allows multi-event capabilities. 
  729. Registration also adds you to the Datagen Software Designs Preferred Mailing
  730. List, and keeps you up to date on what's new with Datagen Software Designs.
  731.  
  732.      Your registration will help Datagen Software Designs in our goal to
  733. produce tons of quality, low cost software.
  734.  
  735.      To register your copy of Data/Voice Switch v1.6 please fill out the
  736. enclosed registration file (DVSWITCH.REG) and mail it to the address
  737. indicated on the form.  Be sure to enclose a check or money order payable to
  738. "Datagen Software Designs c/o John Dailey" for $8.00 U.S., and also be sure
  739. that all information is filled out correctly and completely.  Your
  740. registration will be processed as soon as possible, and a registration
  741. diskette mailed to you in a few weeks.
  742.  
  743. Datagen Software Designs Support BBS Information:
  744. ─────────────────────────────────────────────────
  745.  
  746.      For information on becoming a respectable Datagen Software Designs
  747. support Bulletin Board System, simply mail the below address, with the
  748. following information:  (Note - you must include all information.)
  749.  
  750.           BBS Name,
  751.           BBS Phone Number,
  752.           BBS Type and Version,
  753.           BBS Net/Node (if applicable)
  754.           Disk Size (5 1/4" or 3 1/2")
  755.           Sysop Name,
  756.           Sysop Real Name,
  757.           Sysop Address,
  758.           Sysop Age,
  759.           How Long Your BBS Has Been Up,
  760.           And finally, your reason for wanting to become a support BBS.
  761.  
  762.      Sysop's requesting to become a support board will be notified as soon as
  763. possible on their request, and if accepted, will be eligible to receive
  764. Datagen's Support BBS Newsletter, technical support on all Datagen products,
  765. and MUCH more!  Send requests to:
  766.  
  767.           Support BBS Information
  768.           Datagen Software Designs
  769.           1732 Wind Drift Rd.
  770.           Orlando, FL  32809
  771.  
  772.